Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 9 - Camera Objects / Camera Objects Reference

Data Structures

View Plane Camera Data Structure

You use a view plane camera data structure to get or set information about a view plane camera. A view plane camera data structure is defined by the TQ3ViewPlaneCameraData data type.

typedef struct TQ3ViewPlaneCameraData {
   TQ3CameraData              cameraData;
   float                      viewPlane;
   float                      halfWidthAtViewPlane;
   float                      halfHeightAtViewPlane;
   float                      centerXOnViewPlane;
   float                      centerYOnViewPlane;
} TQ3ViewPlaneCameraData;

Field Description

cameraData

A camera data structure specifying basic information about the view plane camera.

viewPlane

The distance to the view plane from the location of the camera. The value in this field must be greater than 0.0. The view plane should be set at the object whose dimensions and location are specified by the following four fields.

halfWidthAtViewPlane

One half the width of the cross section of an object.

halfHeightAtViewPlane

The value in the halfWidthAtViewPlane field divided by the aspect ratio of the view port.

centerXOnViewPlane

The x coordinate of the center of the object in the view plane.

centerYOnViewPlane

The y coordinate of the center of the object in the view plane.